home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / xymodem.doc < prev    next >
Text File  |  1995-03-31  |  7KB  |  211 lines
  1. (Comp.sys.hp48) 
  2. Item: 1529 by alou@elde1.epfl.ch 
  3. Authors: E. Westphal & M. Alou 
  4. Subj: X&Y Modem v2.0 transceiver 
  5. Date: 04 Aug 1992 
  6.  
  7. [Note: And yet another terrific battery saver!  Check this out!  -jkh-] 
  8.  
  9. ---------------------------------------------------------------------- 
  10. *             Just a little full X & YModem...   FOR Hp48            * 
  11. *             Ver 2.0                                                * 
  12. ---------------------------------------------------------------------- 
  13. WARNING: IF YOU WANT TO USE THIS PROGRAM, IT WILL BE AT YOUR OWN RISK. 
  14. WE CANNOT BE RESPONSIBLE FOR ANY DAMAGES OR LOSSES OF ANY KIND. 
  15. ---------------------------------------------------------------------- 
  16. PRE-INTRODUCTION 
  17.  
  18.   Please excuse our poor English. It is not our native language... 
  19.  
  20. INTRODUCTION 
  21.  
  22.   Because we were programming in ML we had many "memory lost". Then, 
  23. we decided to make a program to load our backup faster than Kermit. 
  24. The result is this version of XYModem loader: 
  25.             About 8 time faster (than Kermit)!!! 
  26.             That means 2' to load about 100KB 
  27.  
  28.  
  29. WHAT IS XMODEM ? 
  30.  
  31.   XModem is a simple file transfer protocol. This is why it is faster 
  32. than Kermit. For example the filename is not sent. 
  33.  
  34.  
  35. WHAT IS YMODEM ? 
  36.  
  37.   YModem is an enhanced version of XModem: it can receive file's 
  38. information (filename, file size, ...) and can send more than one 
  39. file at one time (Batch mode). 
  40.  
  41.  
  42. WHAT IS CRC AND CHK ? 
  43.  
  44.   CRC = Cyclic redundancy control. CHK = checksum. Well, both are a 
  45. way to control the integrity of data. CRC is safer and slower than 
  46. CHK. 
  47.   In batch transmission, the receiver automatically requests CRC. 
  48.  
  49.  
  50. WHAT TO USE WHEN ? 
  51.  
  52.   use batch mode (YModem CRC) To get more than one file . 
  53.   use YModem To get one file only! 
  54.   THEN, WHY XMODEM ? 
  55.   There is two reasons for using it: 
  56.     -If you don't need the file's information. 
  57.     -If you choose the CHK control. 
  58.     For instance, you can use XModem in order to download your backup. 
  59.  
  60.  
  61. HOW DO I INSTALL THAT ? 
  62.  
  63.  1/ Download the ASCed version to your Hp. 
  64.  2/ UnASC the program with ASC->. 
  65.  3/ Type "0 STO" press OFF then ON 
  66.  
  67.  The library name is "X-Y Modem v2.0". Lib number is 1275. 
  68.  That's all (folks)! 
  69.  
  70. HOW DO I USE IT ? 
  71.  
  72.   First, you must call the library. After that, you have five soft 
  73. keys: "SETUPXYM", "SENDM", "RECVM", "ARCHM" and "ABOUTXYM".  
  74.   SETUPXYM: 
  75.     It is a soft menu where you can find: "BAT", "CRC", "REPL" and 
  76.     "EXIT": 
  77.       BAT = ymodem (if checked) or xmodem (if not). 
  78.       CRC = crc (if checked) or checksum (if not). 
  79.       REPL = replace file (if checked) or not. 
  80.       EXIT = LastMenu. 
  81.   SENDM: 
  82.     Start an upload transfert. It need on the stack: 
  83.       a/ 1:GlobalName -> 1:{unsend files} 
  84.       b/ 1:LocalName -> 1:{unsend files} 
  85.       c/ 1:{name(s)} -> 1:{unsend files} 
  86.       d/ 1:Any object -> 
  87.       a, b & c are automaticaly sended in ymodem (batch crc). d is in 
  88.       xmodem. 
  89.   RECVM: 
  90.     Start a Download transfert. It need nothing on the stack. 
  91.   ARCHM: 
  92.     Send in ymodem directly a Backup HOMEDIR. It need on the stack the 
  93.     name of the new file: 
  94.       a/ 1:GlobalName -> 
  95.       b/ 1:"String" -> 
  96.   ABOUTXYM: 
  97.     We assume that you know how to use it... 
  98.  
  99. IMPORTANT REMARK 
  100.   If you send a file in xmodem mode, unlike ymodem, the size of your 
  101.   original file is not send with the file itself. Then you cannot  
  102.   receive it back with the standard kermit RECV. However you can  
  103.   receive it indifferently with x or ymodem. 
  104.  
  105.   The easiest way, at this point, is to give you some examples: 
  106.  
  107.   1/ You want to get one or more files with YModem-batch: 
  108.  
  109.     Set "BAT" on your Hp48. 
  110.     Initiate the procedure on the other computer (YModem, short 
  111. packet) 
  112.     Then press "RECVM" 
  113.     You will, normally, find these files in the directory where 
  114. you are on the Hp. If one or more of these files already exist, the 
  115. variables will be overwritten, or not, depending of flag -36 (Owner's 
  116. Manual p.628, 702). You can adjust this flag with the softkey "REPL". 
  117. If the filename is invalid, unlike Kermit, the program just saves the 
  118. file on "XYM". 
  119.  
  120.   2/ You want to get one file with CHK control: 
  121.  
  122.     Clear "BAT" and "CRC". 
  123.     Initiate the procedure on the other computer (XModem, short 
  124. packet, checksum) 
  125.     Then press "RECVM" 
  126.     You will, normally, find this file on the stack. 
  127.  
  128.   3/ You want to get one file with CRC control: 
  129.  
  130.     Clear "BAT" and set "CRC". 
  131.     Initiate the procedure on the other computer (XModem, short 
  132. packet, CRC) 
  133.     Then press "RECVM" 
  134.     You will, normally, find this file on the stack. 
  135.  
  136.  
  137. IF I DON'T LIKE YOUR PROGRAM: HOW DO I REMOVE IT ? 
  138.  
  139.   Type the following instructions: 
  140.     HOME 
  141.     0:1275 
  142.     DUP 
  143.     DETACH 
  144.     PURGE 
  145.  
  146.  
  147. I GET AN ERROR MESSAGE WHAT DOES IT MEAN ? 
  148.  
  149.   All errors are "fatal transmission error" thus the communication 
  150. will always abort. If you get "SOH Expected" perhaps you forget to 
  151. switch on the option "Short packet" on your computer. 
  152.  
  153.  
  154. SPECIFICATION OF THIS LIBRARY: 
  155.  
  156.   User flags 57, 58 and system flag -36 are used: 
  157.     -36 is the system flag for file replace (Owner's Manual p.628, 702). 
  158.     57 is set for CRC on. 
  159.     58 is set if batch is selected. 
  160.   Library number is 1275. 
  161.   Library size: 3372 (You said that's impossible ? Perhaps you have to 
  162.   try it) 
  163.   Library checksum: #64CAh 
  164.  
  165. DOES YOUR PROGRAM HAVE ANY LIMITATIONS ? 
  166.  
  167.   Well no, 
  168.   just that... 
  169.     -This program can only send or receive the binary representation  
  170.     of an object. In reception, if the file is not interpreted as a  
  171.     valid object, the file will be saved as a string. 
  172.    -Because the limit of the Hp48 receiving buffer size is 255 bytes, 
  173. the long packet option (1024 bytes) cannot be used. 
  174.    -As Murphy said: "There is always one more bug." 
  175.  
  176. WHERE CAN I FIND COMMUNICATION PROGRAM 
  177.  
  178. ftp 128.214.6.100  
  179. login anonymous 
  180. password : e-mail adresse 
  181. ;for pc user :  
  182. cd pub\msdos\communications\procomm 
  183. bin 
  184. get pcplus.zip 
  185.  
  186. ;for mac user : 
  187. cd pub\mac\comm 
  188. bin 
  189. get zterm09.cpt 
  190.  
  191. use CompactPro to decompact it. 
  192.  
  193.  
  194. Let us thanks: 
  195.   Hewlett-Packard for their Tools. 
  196.   Alonzo Gariepy for his Saturn Processor Notes 
  197.   Jan Brittenson for his Star and his MLDL library 
  198.   DM&RH for their Library constructor 
  199.   Chuck Forsberg for his notes on the protocols XModem and YModem 
  200.   And to all people who gave us a lot information about Hp28, 48 on 
  201. mail, news and FTP-server. 
  202.  
  203. Any comments, bugs reports, ... are welcome on this mail address 
  204.  
  205. "ALOU@ELDE.EPFL.CH" 
  206.  
  207. or "WESTPHAL@ELDE.EPFL.CH" 
  208. ---------------------------------------------------------------------- 
  209. WARNING: IF YOU WANT TO USE THIS PROGRAM, IT WILL BE AT YOUR OWN RISK.  
  210. WE CANNOT BE RESPONSIBLE FOR ANY DAMAGES OR LOSSES OF ANY KIND. 
  211.